README Contents
============================================
1.  Introduction
2.  System Requirements
3.  Release Notes
4.  Features and Its Usage
5.  Known Issues and Bug Reporting
6.  License Agreement
7.  3rd party software

********************************************************************************************************************************************************************************************************

1.  Introduction
============================================
This README file contains release notes for the Intel(R) PMT IPF Extension Provider, description and usage of all the features, any problems or issues that were known at the time of shipment.


Intel(R) PMT IPF Extension Provider Overview:
--------------------------------------------
Intel® PMT IPF Extension Provider helps to expose the Platform telemetry data which is available through Platform Monitoring Technology (PMT). The PMT Provider (PMTProvider.dll) is a dynamic link 
library which uses the IPF Framework and communicates with Intel® Telemetry Aggregator Consumer Driver (TACD) which in turn interacts with Intel® Platform Monitoring Technology Driver to discover the 
telemetry space in the system hardware. TACD uses the discovery details obtained by above step to collect raw Telemetry data exposed by Telemetry end point. The raw telemetry data obtained from TACD 
will be processed by the PMT Provider and made available to clients/consumer solutions using the provider. This provider also uses the Intel(R) Platform Register Interface Driver (PRI Driver) to read 
the platform registers to capture some of the frequency data from the system.


2.  System Requirements
============================================

a. Microsoft® Windows 11 Desktop OS (Build 22000.100 and above)
b. The utility supports the following microprocessors:
    (i)  Intel® Core Processor Line Code name AlderLake Processor (SKU - S, SKU - P)
    (ii) Intel® Core Processor Line Code name RaptorLake Processor (SKU - S, SKU - P)
    (iii) Intel® Core Processor Line Code name MeteorLake Processor
    (iv) Intel® Core Processor Line Code name LunarLake Processor
    (v) Intel® Core Processor Line Code name ArrowLake Processor
    (vi) Intel® Core Processor Line Code name PantherLake Processor
c. BKC Kit Number: 
    RPL S Kit ID -> 738211
    RPL P Kit ID -> 738284
    ADL S Kit ID -> 737361
    ADL P Kit ID -> 735700
d. IPF Extensible (V2.2.10204.7) Framework should be the minimum installed version available on the target system.
e. Platform Monitoring Technology (PMT) device should be available and enabled on the target system.


3.  Release Notes
============================================
Release 03.04.1002
    a. TGL ID removed from INF

Release 03.04.1001
    a. WCL compliant release

Release 03.03.1003
    a. Stress and stability fixes

Release 03.03.1002
    a. Fixes for unquoted search path issue for PRI-Driver [PSIRT][PTK0005767]
Release 03.03.1001
    a. Added PTL Support

Release 03.02.1002
    a. Fixes for crash issue seen during initialization.
    b. Updated latest LNL and ARL PMT XMLs.
    c. IPF Provider SDK updated to V2.2.10204.7.

Release 03.02.1001
    a. Fixes for Platform.SOC.States.CState.PackageCstateLlcFlushedResidency. The node will provide data in %.
    b. Updated latest LNL and ARL PMT XMLs.

Release 03.01.1002
    a. Fixes for the "Platform.Cache" namespace issue on ARL.
    b. Fixes for the "Platform.System.Thermal" namespace issue on ARL.
    c. Updated latest LNL and ARL PMT XMLs.

Release 03.01.1001
    a. LNL and ARL PV Release of the provider package built with IPF SDK V2.1.10105.19.
    b. Added new capabilities under Platform.NPU namespace.
    c. Updated the capabilities value type to number from string.

Release 02.05.1002
    a. Added latest LNL PMT XMLs.
	
Release 02.05.1001
    a. LNL and ARL Alpha Release of the provider package built with IPF SDK V2.1.10102.8
    b. Updated LLC Temperature to report max and min current temeperature
            i.   Platform.SOC.Thermal.CurrentTemperature.LLC.Max
           ii.   Platform.SOC.Thermal.CurrentTemperature.LLC.Min

Release 02.04.1002
    a. Fixes for DCH compliance issues

Release 02.04.1001
    a. MTL PV Release of the provider built with IPF SDK V2.1.10100.37.
    b. New Thermal capabilities added as listed below.
            i.   Platform.SOC.Thermal.CurrentTemperature.PCH
           ii.   Platform.SOC.Thermal.CurrentTemperature.DRAM
          iii.   Platform.SOC.Thermal.CurrentTemperature.SA
           iv.   Platform.SOC.Thermal.CurrentTemperature.IPU
            v.   Platform.SOC.Thermal.CurrentTemperature.Display
           vi.   Platform.SOC.Thermal.CurrentTemperature.VPU
          vii.   Platform.SOC.Thermal.CurrentTemperature.Media
    c. Updated GT and Module Temperature to report max and min current temeperature wherever applicable.
            i.   Platform.SOC.Thermal.CurrentTemperature.GT.Max
           ii.   Platform.SOC.Thermal.CurrentTemperature.GT.Min
          iii.   Platform.System.Thermal.CurrentTemperature.Atom[].Max
           iv.   Platform.System.Thermal.CurrentTemperature.Atom[].Min
            v.   Platform.System.Thermal.CurrentTemperature.Core[].Max
           vi.   Platform.System.Thermal.CurrentTemperature.Core[].Min
    d. Updated INF to copy dependencies to Driver Store to fix InfVerif issues.    
    e. Enabled Fixes for the known issues of last Beta Release. Capabilities under below namespace nodes have been enabled for all platforms.
            i.   Platform.System.Thermal
           ii.   Platform.SOC.Thermal
          iii.   Platform.SOC.Performance
    f. All capabilities exposed by this provider under Platform.CPU.Performance node in the namespace is moved to Intel(R) SoC Thermal IPF Extension Provider.

Release 02.02.1002
    Bug-Fix release for MTL Beta with below fixes.
    a. JSON Exception thrown while accessing Platform.SOC namespace node fixed.
    b. "null" values seen for Core Frequency capabilities on waking from sleep has been fixed.
	
Release 02.02.1001
    a. MTL Beta Release of the provider built with IPF SDK V2.1.10060.30
    b. Added MTL support in the provider.
    c. Below capabilities that are available in ADL and RPL have been removed for MTL
            i.   System Agent Voltage and PsOverride
            ii.	 GT Slice and Unslice Frequency
            iii. LLC Cstate
            iv.  ICCPLicense Level
            v.   IA, GT and LLC Temperature
            vi.  Package C-State Device Block Cause PEG
            vii. Package C-state Wake PEG DMI and IOP
            viii.Package C-state LTR Values PCIe
            ix.  Perf Limit Power LLC Residency
            x.   PCIe Gen4 IO Read and Write Bandwidth
    d. Due to a IPF Extensible Framework bug, capabilities under below namespace nodes will not be available in this provider for all platforms. This bug will be fixed in PV release.
            i.   Platform.System.Thermal
            ii.  Platform.SOC.Thermal
            iii. Platform.SOC.Performance
    e. A "null" value will be populated for capabilities in case of unavailability or any error/exception in obtaining the metric.

Release 02.01.1002
    a. Updated provider to link to latest libxml2.

Release 02.01.1001
    a. Migrated to IPF EF SDK V2.0.10100.55
    b. Updated Provider INF to install against the PMT Device

Release 2.0.1001
    Initial Release.

4.  Features and Its Usage
============================================

The Intel® PMT IPF Extension Provider includes the Provider DLL, INF files for installation and associated dependencies. This provider supports telemetry data available from PMT. 
This set of data can be used for debug and validation of Intel platforms. The Intel(R) Telemetry Aggregator Consumer Driver is also part of this provider which gets installed on 
installation of the provider.

Please refer the Intel® Innovation Platform Framework Namespace User Guide for the list of capabilities supported by this provider.
       Document Number: 732035 
       File Download URL: https://cdrdv2.intel.com/v1/dl/getContent/732035 
       
To install, register and use this provider with the IPF Framework, follow below steps.
        a. Open Command prompt in Administrator mode
        b. CD to "Intel(R) PMT IPF Extension Provider" folder
        c. Run below command.
                pnputil /add-driver PMTProvider_ext.inf /install
        d. Restart the system if prompted
        e. Once the system boots back, follow steps 'a' - 'b' and run below command.
                pnputil /add-driver PMTProvider_sw.inf /install
                
To uninstall the provider, follow below steps.
        a. Open Command prompt in Administrator mode
        b. Run below command and get the <oem#.inf> filenames associated with PMTProvider_ext.inf and PMTProvider_sw.inf.
                pnputil /enum-drivers
        c. Once the <oem#.inf> filenames are obtained, run below command for both the <oem#.inf> files
                pnputil /delete-driver <oem#.inf> /uninstall


5.  Known Issues and Bug Reporting
============================================
a. Platform.SOC.States.CState.PackageCstateLlcFlushedResidency will be reported as NULL in ARL and MTL due to a PMT spec issue.
b. To report a bug on this utility, please submit the bug report to your Intel Field Representative.


6.  License Agreement:
============================================
This ReadMe file as well as the software described in it is furnished under license and may only be used or copied in accordance with the terms of the license. The information in this manual is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Intel Corporation. Intel Corporation assumes no responsibility or liability for any errors or inaccuracies that may appear in this document or any software that may be provided in association with this document.

Except as permitted by such license, no part of this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any means without the express written consent of Intel Corporation. 
Information in this document is provided in connection with Intel products. No license, expressed or implied otherwise, to any intellectual property rights is granted by this document. Except as provided in Intel's Terms and Conditions of Sale for such products, Intel assumes no liability whatsoever, and Intel disclaims any express or implied warranty, relating to sale and/or use of Intel products including liability or warranties relating to fitness for a particular purpose, merchantability, or infringement of any patent, copyright or other intellectual property right. Intel products are not intended for use in medical, lifesaving, or life sustaining applications. Intel may make changes to specifications and product descriptions at any time, without notice.
Copyright (C) 2025 Intel Corporation. All rights reserved.

Intel is a trademark or registered trademark of Intel Corporation or its subsidiaries in the registered trademark of Intel Corporation or its subsidiaries in the United States and other countries.


7.  3rd party software:
============================================

a. Libxml2 and its dependencies:
    Intel(R) PMT IPF Extension Provider uses libxml2 (MIT License)
--------------------------------------------

Copyright 2025
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


For more details and terms of use please visit http://www.xmlsoft.org/

********************************************************************************************************************************************************************************************************
*Third-party brands and names are the property of the respective owners.
